Appearance
Alerts Overlay
The Alerts Overlay plays an alert on stream when someone tips or subscribes. It works on its own, so you don't need a StreamElements or StreamLabs account.
Quick Start
- Go to Overlays and choose Alerts.
- Click Preview tip or Preview sub and adjust the options until the preview looks right.
- Copy the overlay URL.
- In OBS, add a new Browser source and paste in the URL. 800 x 600 is a good starting size, and the background is transparent.
- Turn on Control audio via OBS in the source properties so alert sounds play on stream.
- Click Send tip to OBS or Send sub to OBS to check that the alert shows up in OBS.
TIP
The overlay URL holds all of your options. Copy it again into OBS after you change anything.
Presets
A preset is a set of variants with its own overlay URL. Use presets to have different alerts in different scenes, or to try new alerts without changing the ones on stream.
- Create Preset (+) adds a preset with the default variants.
- Rename Preset (pen) changes the selected preset's name.
- Duplicate Preset copies the selected preset and all of its variants.
- Delete Preset (trash can) removes the selected preset after you confirm. OBS sources that already use its URL keep working. You always keep at least one preset.
Pick a preset to edit it. Everything below, including the overlay URL, belongs to that preset. Add a separate browser source in OBS for each preset you want to use. You can have up to 20 presets.
Variants
Every alert comes from a variant. Each variant has its own animation, text, look, duration and volume, and an on/off switch.
- Tips: A tip plays the enabled tip variant with the highest From amount it reaches.
- Subs: A sub plays the enabled variant with the highest From streak it reaches, in months. Each sub tier has its own variants. Subs from a tier without variants use the Any tier variants.
Turn a variant off to skip it, and the next lower one plays instead. To ignore small tips, set the lowest tip variant's From above $0.
Exact matches
Set a variant's Match to Exactly to play it only for one value, such as a $69 tip or a 12-month streak. An enabled Exactly variant that matches always plays instead of the From variants. For subs, a match in the sub's tier comes first, then a match in Any tier. If nothing matches exactly, the From variants play as usual. A tier with only Exactly variants uses the Any tier From variants for every other streak.
Default variants
| Tips | Subs (every tier and Any tier) |
|---|---|
| From $0: Coin flip | From 0 months: Pinball star |
| From $25: Money fan | From 3 months: Constellation |
| From $100: Jackpot | From 12 months: Starfall |
Reset to default variants brings these back. Tiers you add later use the Any tier variants until you click Add default variants next to them.
Variant options
Click Edit on a variant to change its options. They are grouped into sections, and each section shows a short summary of its current settings while it is closed.
Alert
- Match: From starts the variant at a value. Exactly plays it only for that value. See Exact matches.
- From or Exactly: The tip amount or streak in months where this variant starts, or that it matches.
- Text: The headline. Tips can use
{user}and{amount}. Subs can use{user},{tiername},{streak}and{total}. - Show Tip Message: Shows the message that was sent with the tip, with the same emotes as the Chat Overlay: your custom emotes, plus Twitch, 7TV, BTTV and FFZ emotes.
- Alert Duration: How many seconds the alert stays on screen. Alerts that arrive at the same time play one after another.
Visuals
- Animation: The graphic that plays. It gets more intense for bigger tips and longer streaks. Choose Custom to use your own image, GIF or video, then set Image Size (10% to 300% of the built-in animations) and Video Volume for its sound. See Custom images and sounds. Choose None to show only the text. A Custom animation without a file, or with a file that can't be loaded, also shows only the text.
- Layout: Image above the text, beside the text, or behind the text.
Text style
- Text Animation: How the name and amount move: Heartbeat, Wave, Neon sign, Glitter, Shimmy, Type on, Jelly, Dreamy float or None.
- Text Font, Text Size, Text Color, Highlight Color and Message Color
Sound
- Alert Sound: The built-in sound, or your own sound from your media library.
- Volume: Alert sound volume from 0 to 100.
Text-to-speech
- Read Alert Text and Read Tip Message: Read the alert text or the tip message aloud after the alert sound. See Text-to-speech.
- Voice and Speech Volume: The voice that reads the alert, and how loud it is from 0 to 100.
Copy settings to this group copies a variant's settings to the other variants in its group, such as all tip variants or all variants for one sub tier. Copy settings to all variants copies them to every other variant. Everything is copied except Match, From, Text, the animation (including a custom image or video) and the on/off switch, so each variant keeps what makes it different. Show Tip Message and Read Tip Message are only copied between tip variants.
Reset to default puts a variant's settings back to the defaults for its range, such as Money fan for a tip variant from $25. It keeps Match, From, the sub tier and the on/off switch. Click it twice to confirm.
Custom images and sounds
Set a variant's Animation to Custom, or click Choose next to Alert Sound, to open your media library. Upload a file or pick one you already uploaded. Your library is shared by all variants, so you only upload a file once. Pick a built-in animation or click Use default to switch back.
- Images: PNG, JPG, GIF, WebP, MP4 or WebM. Transparency is kept.
- Sounds: MP3, OGG or WAV.
- Limits: 25 MB per file and 100 MB in total. Deleting a file frees up its space. Variants that used it as their sound switch back to the default sound, and variants that used it as their animation show only the text until you pick another file.
Files are optimized in your browser before upload, so they load fast in OBS. Images are resized to at most 1280 pixels and saved as WebP. MP4 videos stay MP4, GIFs and other videos become WebM videos, and sounds become OGG files. Videos and sounds longer than 60 seconds are cut at 60 seconds. Videos keep their sound, which plays at Video Volume. Nothing else about your files is changed.
Text-to-speech
Turn on Read Alert Text or Read Tip Message in a variant to have alerts read aloud after the alert sound. The alert stays on screen until the voice finishes. Choose from 28 English voices, female and male: 20 American and 8 British (marked UK). The voices are sorted by the quality rating their creator gave them, from A (best) to F.
AI-generated voices
Speech is generated by AI on your computer, using the open-source Kokoro-82M voice model (Apache 2.0) through the kokoro-js library. Alert text and tip messages are never sent to us or anyone else, and you don't need an account.
The model (about 330 MB) downloads once from Hugging Face the first time it is used, in the editor and in OBS. It runs on your graphics card when it can, and on your processor otherwise, where speech can take several seconds to start. Tip messages are read exactly as they were written.
GIFs and emotes in tip messages
- GIFs controls GIFs from Tenor and Klipy in tip messages. Follow Fansly (default) uses the "Show Gifs in Messages" setting of your Fansly chat, Show always shows them and Hide always hides them. When a tip message only contains a GIF and GIFs are hidden, the alert plays without the message.
- Emotes turns off emote sources in tip messages: ZerGo0_Bot, Twitch, 7TV, BTTV and FFZ emotes. All sources are on by default.
These settings do not change the preview on the Overlays page. Update the browser source URL in OBS after you change them.
Animations
| Tips | Subs |
|---|---|
| Coin flip: A gold coin flips into the air and lands with a burst of coins | Pinball star: A star bounces around the screen, then lands in the middle |
| Money fan: A stack of bills snaps open into a fan | Constellation: A star outline draws itself, then turns into a big star |
| Jackpot: A slot machine spins and lands on 7 7 7, then money rains down behind it | Starfall: Shooting stars rain down, then a giant gold star slams in |
Testing
- Preview tip and Preview sub play the alert on the Overlays page only, using the amount, months and tier next to the buttons. Preview on a variant plays that variant.
- Send tip to OBS and Send sub to OBS play a test alert in every open Alerts Overlay within a few seconds.
- Test Alerts and Test Sub Alerts under Settings > Alerts also send test alerts to the Alerts Overlay.